home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d13
/
pull230.arc
/
PULL230.DOC
< prev
next >
Wrap
Text File
|
1990-10-15
|
137KB
|
3,250 lines
___________________________________________________________________________
PullDown Menu Shell System, Version 2.30
U.S. ShareWare Release PULL230.ZIP
___________________________________________________________________________
Released 16 October, 1990
User's Guide
All Materials, Files, Contents of Distributed Files,
Software and Documentation (C) Copyright 1989-1990 Sam Horton
and
Copyright (C) 1990 MicroDynamics Development Corporation
1445 Mensch Lane Gilbertsville, PA 19525
ASP Membership Application Pending
CIS ID 72010,2546
GEnie S.HORTON1
All Rights Reserved.
___________________________________________________________________________
TABLE OF CONTENTS
___________________________________________________________________________
Upgrading ............................................................ 1
License, Terms of Use, Distribution .................................. 1
License
Distribution
Consultant Dealerships
Virus Protection
File Description/Librarian's Reference ............................... 1
Introduction ......................................................... 2
Feature Overview
Pure Text Files
Installation, ShareWare Version ...................................... 5
Making Menus ......................................................... 8
Basic Menu Definition
Advanced Menu Definition
Help Subsystem Use/Definition
Using the SAA Interface .............................................. 31
Keyboard
Dialog Elements
Getting Around
Mouse
Configuring the Menu System Options .................................. 33
Option Clusters for Configuration
Colors
Passwords
Registration System
Command Line Parameters .............................................. 34
Technical Support & Registrations .................................... 36
Domestic USA
Germany
Consultant's Dealerships ............................................. 38
APPENDIXES
----------
A: Troubleshooting Guide ............................................. 38
Unexpected return to menu shell, no selection activated
Unexpected Results of a selection and debugging
Tips
Locking system
Mouse Problems
Unexpected System Halts/Fatal Errors
B: Files included in package and used by PullDown .................... 43
C: Foreign Versions & Technical Support in Overseas .................. 44
D: Technical Notes ................................................... 44
E: Key Word Quick Reference (Complete Summary) ....................... 45
F: Load Time Minimization/Performance Optimization ................... 47
Special .DEF keyword MAXDEFS=nn
Considerations
G: Advanced Pathing/LAN Support and Setup ............................ 48
H: Special Thanks .................................................... 50
I: Next for PullDown v2.50-3.00 ...................................... 51
J: MicroDynamics Policy Statement .................................... 52
UPGRADING FROM PRIOR VERSIONS OF PullDown
___________________________________________________________________________
Print and read the file UPGRADE.DOC. It contains all of the information
concerning HOW to upgrade you may need, and an update history of the
evolution of the product. However, we urge you to reprint and peruse this
documentation file, as many new features and important changes have been
made. Your registration number is valid for this and all future releases
of the software. Enjoy!
* All commercial tradenames and trademarks referenced are property of their
respective owners, and MicroDynamics makes no claim to any names or
commercial trademarks commonly known to be held by owners other than
MicroDynamics referenced within this or any other distributed document or
file.
LIBRARIAN'S STANDARD FILE DESCRIPTION:
___________________________________________________________________________
PULL230.ZIP
A sleek SAA compliant professional-style pulldown menu shell for MS-
DOS systems featuring a full range of powerful options permitting
total system customization. Requires Hard Disk, DOS 3.0+, 256K RAM,
IBM PC, XT, AT, PS/2, PS/1 or 100% compatible. 80286 or higher
recommended.
LICENSE AND TERMS OF USE
___________________________________________________________________________
SHAREWARE LICENSE AGREEMENT ACCEPTED BY YOUR USE: As a non-commercial
private user you are permitted to use/evaluate this product at no charge
for a period of 60 days. At the end of that period, if you feel that this
work has some value to you, please consider a donation of $20 (US funds or
your local currency equivalent plus $20) to register the product. Print
and return the enclosed form in the file REGFORM.DOC to request upgrade
diskettes, if desired, and registration numbers. After 50 unregistered
starts, the command line registration system is automatically invoked until
registration. Unregistered copies are fully functional with the sole
exception of permanent saving of custom colors. Commercial business users
are restrained from using the product in the unregistered state under ALL
circumstances. Site licenses and multiple copy terms are covered within
the REGISTRATION section of this document file. MicroDynamics assumes no
liability arising from your use or inability to use this software product,
nor does MicroDynamics assume liability for direct, indirect or
consequential damages resulting from your use.
DISTRIBUTION: PullDown v2.30 MUST be distributed in its original,
unmodified form on only public-access BBS systems, through non-profit
ShareWare libraries, or APPROVED ASP vendor sites and catalogs. ALL
catalog houses are *urged* to notify MicroDynamics of their intent to
dsitribute, as the version they list may not be the latest. ASP approved
sites may begin distribution and then notify MicroDynamics, but unapproved
vendors of shareware may NOT. Any distribution for remuneration beyond the
cost of the diskette/mailing by NON-ASP approved vendor catalogs is
strictly forbidden without the written permission of MicroDynamics and the
author. (User group demo and distribution for member donation excepted.)
Consultants/Dealers can obtain an on-site registration system upon
acceptance of the "Dealer" agreement obtained from MicroDynamics.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 1
CONSULTANT DEALERSHIPS: Dealers and Consultants are presently using an
onsite registration system and remitting a percentage of collected
registration fees while providing a very clean professional look to their
client's systems. If you would like to join that growing list, please
notify MicroDynamics in writing, or call one of the technical support
centers. A simple contract will be returned to you for approval. Voice
support is available to registered Dealers and Consultants.
VIRUS PROTECTION: The authorized shareware distribution copy of this
software is contained within a tamper-proof ZIP file called PULL230.ZIP.
If you did NOT see a banner notifying you that the ZIP file you received is
valid upon invoking PKUNZIP, then assume the worst and find another copy.
In fact, you are strongly advised to run a virus-checking program
immediately after UNZIPPING *ANY* file or files from ShareWare libraries or
Public Domain sources. However, please don't give in to the unfounded and
frequently hysterical "fear cum mania" associated with the entire issue of
computer viruses.... just be careful, and enjoy! Finally, if PullDown
refuses to start, displaying a message "CRC Check Failed!" then immediately
check the system for virus presence. PullDown contains a measure of anti-
virus self-checking, and should not start if the file is modified in any
way.
INTRODUCTION
___________________________________________________________________________
What are PullDown menus? In short, they are identical to the familiar
PCTools Deluxe interface, and very similar to the Windows pulldown menus
you are likely already familiar with.
The purpose of the menu shell is to make access to programs contained on
the PC to be effortless. Moreover, in the case of PullDown, the process
becomes both elegant and efficient. PullDown is unique among menuing
shells, providing you with the ability to define truly professional quality
menus for any system quickly using a simple text editor (or Word Processor
saving files as text only) and a set of easy to master commands. Beyond a
reasonable working knowledge of DOS, and the ability to learn, no other
expertise is required to use PullDown. However, if you should become
confused as your read through the documentation please seek assistance from
a knowledgeable co-worker, a friend, or call one of the Technical Support
BBSs... MicroDynamics wants to serve you in any way possible, and to the
extent time is available even unregistered users can get technical support
from the author of the product. Please, if you have ANY trouble, or
suspect the menu system of "locking" or otherwise interfering with your
computer, then call for support!
PullDown, in summary, contains the following features:
* Professional quality SAA compliant PullDown menus with custom color,
screen mode, dialog, and mouse control.
* All of the basic menuing system features including password
protection, command line prompts, and screen blanking, PLUS user-
defined help for each menu item, defined dialog boxes ranging from
simple <Ok> and <Yes><No> one-liner messages to full screen scrolling
message boxes and custom file loading input systems.
* Color, Background Fill control, and unlimited upgrades via a command
line registration system.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 2
* Support for up to 10 Top Bar menu items with up to 46 selections
EACH, with unlimited menu file branching--practically limitless
options can be defined. Even an AutoExec option is possible.
* Automatically resumes the state of the menus as you left them last,
and can be toggled to turn NumLock off on entry automatically.
* Non TSR design assures conflict-free operation. Clear, concise
manual with troubleshooting guide and quickref cards included.
To configure the menu system properly, a working knowledge of DOS is most
helpful, as well as some programming background. The programming
background would help you understand very quickly how to configure the
menus, but is NOT required to operate the system. More importantly, you
must be familiar with the distinction between so-called "pure" text files
and standard word processing files. For those who do not know what this
means, let's take a minute to explain the differences, and finally to tell
you how to save a file as pure text--the kind PullDown needs to operate
correctly. (If you already intend to use a text editor, then skip on ahead
three or four paragraphs.)
[NOTE: It is assumed that the reader has used a word processor before, and
if you have never used one, then it is likely that you will need some help
setting up this menu system.]
When you edit or create a word processing file, regardless of the word
processor you use, you first LOAD the file, work with it, and then SAVE the
file. Loading and editing a pure text file is no different from working
with any of your standard word processing files.... it is the SAVE function
that differs. To save a pure text file instead of the usual format of your
word processor, select the option TEXT ONLY, or TEXT WITH LINE BREAKS as an
option just before you save. The following paragraphs deal with exactly
how do this in Word Perfect and MS Word.
WORDPERFECT v5.1: [Alt =] [Text Out] [Dos Text]
Then enter the filename. The file will be saved without any special
formatting options as pure text, with line breaks.
MS WORD, v5.0: [Esc] [Transfer] [Save] [Tab] [Space] [Space] [Enter]
This selects Text-only-with-line-breaks, which saves a pure text file.
Using the Text-Only selection will create a file which may not be
compatible with PullDown's help system. See your manual for details.
If you are using WORD for WINDOWS, the process is quite similar, only
you select the option from within a dialog box instead.
If you use another package, look in the index of your manual for Save
Options/ASCII/Files or SAVE AS TEXT for references on how to do this. If
you are familiar with the use of text editors such as PE2, PE3, QEDIT,
MultiEdit or ZIA, then simply use on of those to create and maintain the
required files.
As an aside, the reason that you cannot simply save in your word
processor's native format is twofold. First, word processors wrap the
lines for you on screen from long lines. For example, a paragraph is
wrapped for you when you type it in, you don't have to press ENTER at the
end of each line. This is achieved by saving the paragraphs on disk (and
memory) as one very long line, and then wrapping them on your screen or
_____________________________________________________________________________
PullDown v2.30 Documentation Page 3
printer on the fly. Second, certain characters, known as control codes,
are saved within the word processor's document to store attributes of your
text such as bold, underline, indented, left or right justified and so on.
In most cases, "header" information about the overall document format like
margins, running footers etc. is also stored within the file. If you were
to view one of your word processing files straight, without the benefit of
the word processor's interpretation of the control codes, you would see
smiling faces and other goop on your screen, along with your text.
PullDown is not equipped to interpret the extra formatting information, nor
is it useful to the menu system. The first thing to check, if a menu
behaves unexpectedly or a defined help screen looks bizarre, is the format
in which you saved the file. If in doubt, issue the following command at
the DOS prompt to check the file out:
TYPE FileName.EXT
Where: FileName.EXT is the file you suspect you saved incorrectly. If you
get any beeping, strange characters you did not type in, or weird
formatting like lines falling off the screen, then the file was saved in
the word processor's format. To correct it, load the file again using the
word processor, and then save it in the correct text-only format.
Finally, to configure the menu system you MUST know the following about
each of the programs you will place under the shell:
* The DOS Drive it is contained on.
* The DOS Directory it is in.
* The command used to start the application.
And, to have the system start each time you turn on your PC:
* Where the special DOS file AUTOEXEC.BAT is.
* Whether or not you are presently using another menu system.
Is is presumed you know the first set of information about your programs,
but just in case you are unclear, here is a short example of the DOS
commands one might type to start Lotus 1-2-3 on drive C: in the directory
LOTUS:
C: [ENTER]
CD\LOTUS [ENTER]
123 [ENTER]
And 1-2-3 would start. In order, you typed the drive it was on, the
directory it was in, and the command to start the program. You will need
this same information about each application you will place under the menu
shell. In version 3.00 of PullDown, an automated installation routine will
do all of this for you, but for now you will need this information when
configuring the shell.
Making PullDown start each time you turn your PC on is covered in detail
under INSTALLATION below. It is really easy to do, although it sounds
cryptic when first explained.
This manual is divided into the following general sections:
- Installation, menu configuration, and interface usage
- Menu system options
- Technical Support and Registration
- Appendixes on Troubleshooting and Technical Details
_____________________________________________________________________________
PullDown v2.30 Documentation Page 4
We hope that you find this reference document lucid and easy to use. As
always, your comments, suggestions, and feedback on the documentation are
more than welcome. Enjoy.
INSTALLATION
___________________________________________________________________________
In the ShareWare form, the menu system is typically distributed within a
PKZIP file called PULL230.ZIP. ZIP files, as they are called, are simply
compressed sets of other files. To remove the files from the ZIP file, and
make them useful, you must UNzip them using the PKUNZIP utility from
PKWARE. Assuming that you are installing the menu system for the first
time, follow these steps in order to uncompress the files from a diskette
in drive A: to the subdirectory MENU on drive C:. If you have the ZIP file
on a different drive, or within a subdirectory, then substitute that
information where you see the A: drive letter below. Of course, you can
use any subdirectory or drive other than C:\MENU, just substitute your
information in place of C:\MENU. Where not noted below, press the [ENTER]
key after each command.... you MUST have a copy of PKUNZIP on your system
and available to UNzip the files for this to work.
1. Place the PullDown installation or distribution diskette in drive A:
2. Type the following at the DOS prompt.
C:
MD\MENU
PKUNZIP A:PULL230 C:\MENU
******** IMPORTANT ********
The files will be extracted, and when the process is finished you
should see the following message on your screen:
Authentic files Verified! # UQL485 (C) MICRODYNAMICS DEVELOPMENT /
S.HORTON
IF YOU DO NOT see this message, then you cannot be sure that you
received a fully functional unmodified VIRUS-FREE copy of PullDown.
It is suggested that you call the tech support BBS, notify
MicroDynamics of the problem and where you obtained the file, and
download the guaranteed clean copy of the system from the BBS. The
BBS is on (215)-623-6203 24 hours a day, or (215)-363-6625 with
advance registration. If you cannot do this, then a diskette
containing the program will be sent to you free of charge for
notifying MicroDynamics of the error(s) you encountered. Viruses and
hackers are rightly maligned, and we will do everything we can to
limit their impact on your enjoyment of the software.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 5
3. Edit the batch file used to start the menu system
Using your text editor, or a word processor saving files in pure text,
edit the file PULLDWN.BAT to match your menu system IF you did not
install it exactly as described above. That is, if you substituted a
drive other than C:, or a directory other than \MENU for the system,
then you will have to modify the batch file used to call the menu
system. The DEFAULT contents of that file are the following:
ECHO OFF
CLS
REM PullDown Menu Shell System (C) 1990 MicroDynamics Development
REM File=PULLDWN.BAT Modify as required.
C:
CD\MENU
PULLDWN1.EXE %1 %2 %3 %4
IF ERRORLEVEL=1 GOTO ExitOnError
TEMPULL.BAT
:ExitOnError
Again, substitute your drive letter for C:, and your path for \MENU if
you used something other than the default information described in
step 2.
4. Copy the file PULLDWN.BAT to C:\, and/or place \MENU in your PATH.
This is necessary in order to support starting PullDown from anywhere
you happen to be in your system easily. If you elect to copy the file
PULLDWN.BAT to the root (\) directory of drive C:, your system will
always be able to find it, regardless of the PATH setting in
AUTOEXEC.BAT. [If that statement confused you, just follow the
directions for copying the file to the root directory and be done with
it.] If you wish, you may modify the PATH to include C:\MENU.
A) Copying the file.
COPY C:\MENU\PULLDWN.BAT C:\
B) Changing the PATH command. (Optional but recommended)
1. Edit C:\AUTOEXEC.BAT and modify the path. Append with
;C:\MENU
2. Save the file as pure text
5. IF you want PullDown to start automatically each time you turn your
computer on, and you have a hard disk on which the first partition is C:
(the first drive letter that is a hard disk) then follow these steps with
care.
A) Edit the file C:\AUTOEXEC.BAT. If it does not exist, then create
it anyway.
B) IF the file already exists, then perform the following edit:
1) If you were using another menu system, and it used to start
when you turned your PC on, then you will have to replace the
command used at the end (most likely) of your AUTOEXEC.BAT file
with PULLDWN to start the new shell. Look on the last line, if
you see AUTO, 3DMENU, 3D, EZ, EZMENU, M, or MENU, then overtype
_____________________________________________________________________________
PullDown v2.30 Documentation Page 6
it with PULLDWN. If you see nothing like that, then add the line
PULLDWN to the file after the last existing line. TIP: If the
menu system fails to start after you have done this, then check
with an experienced user or send the contents of the file to
MicroDynamics on the tech support BBS for assistance.
2) Save the file as pure text.
C) IF the file does not exist at all, then enter these lines to create
a sample file that will start PullDown automatically.
1) Enter these lines.
ECHO OFF
CLS
SET PROMPT=$p$g
PULLDWN
2) And save the file as pure text.
6. Decide which text editor or word processor you will be using to
configure and run PullDown with. Write down the program's drive,
directory, and the command you use to call it up with. The example below
assumes that you will use QEDIT in the directory C:\QEDIT. Full paths are
shown as samples only, and do not need to be used if C:\QEDIT is already in
your path. TIP: If you need to know what IS in your path, then type the
command SET at the DOS prompt and look at the line with PATH on it.
A) Edit the file EDITOR.BAT in C:\PULLDWN. You will see the
following contents:
ECHO OFF
CLS
REM EDITOR.BAT for inclusion with PullDown menu system.
C:\QEDIT\Q %1
B) SAMPLE: If you are using PE2, which is contained within the
directory C:\EDITOR, then change the file to the following:
ECHO OFF
CLS
REM EDITOR.BAT for inclusion with PullDown menu system.
C:\EDITOR\PE2 %1
C) SAMPLE: If you are using WordPerfect v5.1 in the directory F:\WP51
then change the file to the following:
ECHO OFF
CLS
REM EDITOR.BAT for inclusion with PullDown menu system.
C:\WP51\WP %1
And be sure to save the files you edit for PullDown as pure text. (DOS
Text in the case of WP). You need to modify this batch file so that the
selections in the menus concerning editing of the .DEFinition files is
correct. (i.e. The selections call "EDITOR FileName.DEF".)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 7
MAKING MENUS
___________________________________________________________________________
The files that contain the definition information PullDown uses to create
menus have the extension .DEF. The included files are PULLDWN.DEF, which
is the default menu file PullDown will load on startup, ADVANCED.DEF, which
contains several advanced examples, and WINDOWS.DEF, which demonstrates
starting Windows Apps from PullDown. These files, and the ones you might
create in the future, are pure text files with line breaks. That is, when
you edit them you MUST save them as described above under the INTRODUCTION
section. Files in any other format will cause PullDown to fail when
loading the definitions. These .DEF files are loaded by PullDown and the
menus you describe within them are displayed on screen. Each title is
defined explicitly, and is followed by the command(s) to be issued to DOS
through TEMPPULL.BAT. That is, the defined commands you give PullDown in a
.DEF file are written into the file TEMPPULL.BAT, and then that file is
executed when you make a selection. Recall from above the contents of
PULLDWN.BAT...
ECHO OFF
CLS
REM PullDown Menu Shell System (C) 1990 MicroDynamics Development
REM File=PULLDWN.BAT Modify as required.
C:
CD\MENU
PULLDWN1.EXE %1 %2 %3 %4
IF ERRORLEVEL=1 GOTO ExitOnError
TEMPULL.BAT
:ExitOnError
That second to last line containing TEMPPULL.BAT is executed after you exit
the menu shell. PullDown basically creates a batch file called upon by
TEMPPULL.BAT that contains the menu definitions you create. Now, let's see
how a basic menu is constructed, and then move on to the more advanced
features of the menu shell.
BASIC MENU DEFINITION
=====================
The basic keywords used by PullDown are:
DEF
Defines a new title heading to follow, and a new pulldown set.
%TitleString
1) When immediately following DEF, defines top menu selection
2) When second through last for a menu, defines the title of the
selection definition that follows it.
+BatchCommand
Following a %TitleString defines a DOS batch command associated with
the preceding selection title.
'CommentString
Anything preceded by ' is a comment and ignored by PullDown. Embedded
comments are not supported, so keep them on separate lines.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 8
To demonstrate how this works, suppose you wanted to create a PullDown menu
for your applications containing 1-2-3, Harvard Graphics, and MS Word 5.0.
The corresponding DEF file would look like this, of course adjusted to
reflect the DOS subdirectories and drive(s) in your system:
DEF
%Applications
%Lotus 1-2-3
+C:
+cd\lotus
+123
+pulldwn
%Harvard Graphics
+c:
+cd\harvard
+hg
+pulldwn
%MS Word 5.0
+c:
+cd\word5
+word
+pulldwn
And the result on screen would look something like this, but better of
course, as this is just roughed out here for tutorial purposes...
Applications
---------------------
| Lotus 1-2-3 |
| Harvard Graphics |
| MS Word 5.0 |
---------------------
NOTES: The keyword DEF tells PullDown that a new TOP BAR menu definition
follows. See how that first one is Applications, and how all the others
fall in under it? The keyword DEF is special in that way, and is used ONLY
when you want a new menu selection and attendant subselections to follow.
That last line on each selection, PULLDWN, ensures that the menu shell will
be restarted for you after you use each program. If you omitted it, you
would be at the DOS prompt (C:\ or similar) upon exit from an application.
To continue with this example, suppose that you wanted to add another menu
selection containing your utilities. One for the Norton Utilities, one for
PC Tools Deluxe, FastBack Plus, and finally a selection to format a
diskette in drive A:. You would then ADD to the above file the following
definitions: ---
_____________________________________________________________________________
PullDown v2.30 Documentation Page 9
' Second TOP BAR is Utilities.... (This is a comment ignored by PullDown)
DEF
%Utilities
%Norton Utilities
+C:
+cd\nu
+nu
+pulldwn
%PC Tools Deluxe
+c:
+cd\pctools
+psshell
+pulldwn
%FastBack Plus
+c:
+cd\fastback
+fb
+pulldwn
Format Diskette in Drive A:
+format a:
+pulldwn
Then, your menu would FIRST appear on screen like this.....
Applications Utilities
---------------------
| Lotus 1-2-3 |
| Harvard Graphics |
| MS Word 5.0 |
---------------------
Upon pressing the RIGHT arrow key, or sliding the mouse across the top bar
while holding the left button, the menu would switch to the second TOP
selection and appear something like this....
Applications Utilities
-----------------------------
| Norton Utilities |
| PC Tools Deluxe |
| FastBack Plus |
| Format Diskette in Drive A: |
-----------------------------
_____________________________________________________________________________
PullDown v2.30 Documentation Page 10
Thus, the whole file contains:
------------------------------
DEF
%Applications
%Lotus 1-2-3
+C:
+cd\lotus
+123
+pulldwn
%Harvard Graphics
+c:
+cd\harvard
+hg
+pulldwn
%MS Word 5.0
+c:
+cd\word5
+word
+pulldwn
' Second TOP BAR is Utilities.... (This is a comment ignored by PullDown)
DEF
%Utilities
%Norton Utilities
+C:
+cd\nu
+nu
+pulldwn
%PC Tools Deluxe
+c:
+cd\pctools
+psshell
+pulldwn
%FastBack Plus
+c:
+cd\fastback
+fb
+pulldwn
%Format Diskette in Drive A:
+format a:
+pulldwn
And a complete working menu is defined. But, PullDown contains many more
features to spice up the menus, and two of them are the HighLite key and
the unselectable horizontal bar.
HighLite (or HiLite) keys are used to permit quick keyboard access to a
selection. Like PC Tools, PullDown employes the SAA (standard applications
architecture) definition of their behavior. That is, if you press
ALT+HighLite Key the selection is made, if you press and release ALT, then
the HighLite keys are lit and stay lit until one is pressed. (NOTE:
PullDown starts in this state, but the Dialog Boxes require an ALT press)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 11
Pressing a lit HighLite key moves your cursor to the selection indicated.
In the case of multiple keys on screen, the first one encountered moving
down the current menu is selected. The unselectable bar is there for
aesthetic separation of options only. First, suppose that you wanted the L
in "lotus 1-2-3" to be a HighLite key. You would change the portion of the
selection as shown below: (The dots before and after indicate that the
example is a code fragment, and that other things follow and/or precede
it.)
.
.
%Lotus 1-2-3
HI=0
+C:
+cd\lotus
+123
+pulldwn
.
.
The only thing changed is the addition of the HI=0 statement. HI=nn
defines the character position of the highlite character in the preceding
title. It has no meaning if following the TOP BAR titles APPLICATION and
UTILITIES, but does have meaning in any other context. Note that the
default for the system, if you do not specify HI= for each selection, is
the HI=0 position. Now, why is the position 0 in HI=0 and not 1? Easy, we
start counting the positions in the title at 0, not 1. So the O in Lotus
is position 1, not 2 as you might suspect. A good habit to get into is
placing a counter comment line above each selection to avoid confusion.
e.g.
.
.
'01234567890
%Lotus 1-2-3
HI=0
+C:
+cd\lotus
+123
+pulldwn
.
.
To drive the point home, what number would follow HI= to highlite the 2 in
1-2-3 above? The answer is 8, as you can see plainly. Continuing on the
unselectable divider bars, suppose you wanted to add one between the
FastBack Plus and Format options under the UTILITIES top bar menu... you
would do this by adding the special %- command which defines the bar like
this:
_____________________________________________________________________________
PullDown v2.30 Documentation Page 12
. .
%FastBack Plus
+c:
+cd\fastback
+fb
+pulldwn
' The %- below inserts the unselectable bar to separate selections.
%-
%Format Diskette in Drive A:
+format a:
+pulldwn
.
.
And, the menu appearance would CHANGE to this when the UTILITIES menu is
displayed:
Applications Utilities
-----------------------------
| Norton Utilities |
| PC Tools Deluxe |
| FastBack Plus |
|-----------------------------|
| Format Diskette in Drive A: |
-----------------------------
Examining and modifying the PULLDWN.DEF file will give you a good flavor
for using these and other options. In summary, the basic keywords and menu
file structure are:
DEF
Defines a new title heading to follow, and a new pulldown set.
%TitleString
1) When immediately following DEF, defines top menu selection
2) When second through last for a menu, defines the title of the
selection definition that follows it.
+BatchCommand
Following a %TitleString defines a DOS batch command associated
with the preceding selection title.
'CommentString
Anything preceded by ' is a comment and ignored by PullDown. Embedded
comments are not supported, so keep them on separate lines.
And the basic structure of ALL .DEF files is:
---------------------------------------------
_____________________________________________________________________________
PullDown v2.30 Documentation Page 13
DEF
%TopBar Title One
%First Selection
HI=nn
+batch command
+batch command
%Second Selection
HI=nn
+batch command
+batch command
.
.
DEF
%TopBar Title Two, appearing to the RIGHT of the preceding menu
%First Selection, Menu Two
HI=nn
+batch command
+batch command
%Second Selection, Menu Two
HI=nn
+batch command
+batch command
.
.
And so on, up to 10 total top bar menus, limited in depth down the screen
to the number of rows on the screen minus four. (Discussed later.) Of
course indenting the lines is optional, but helps the eye follow selections
and contents easily. Next, advanced menu elements such as password
protection, command line parameter passing, and dialogs are covered. After
that discussion, an overview concerning use of the interface with both the
keyboard and the mouse is explained.
ADVANCED MENU DEFINITION
========================
The advanced elements of menu definition are:
PASS=PassWord
User is prompted for a password to continue. The selection halts
execution at the line PASS is encountered if the user cannot enter the
correct response, or selects <Cancel>/presses ESC.
?QuestionString
Shows the user PromptString and awaits input. If the user selects the
<Cancel> or presses ESC, the execution of the selection halts and the
user is returned to the menu. Up to 10 are supported, and passed to
the batch file on a command line as if keyed.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 14
LOADFILE=FileSpec,HeadingComment Presents user with a professional style
file load dialog, complete with the ability to traverse the entire system,
event handling, and mouse support. The Heading Comment is optional, but
encouraged. This dialog returns to the command line the file name entered
by the user. A new file name can be entered at will, but the dialog will
remind the user that the file does not yet exist before continuing.
OKBOX=PromptString
Places a single <Ok> dialog box before the user containing only the
string PromptString. If the user clicks on <Ok>, or presses ENTER,
then execution continues. If ESC is pressed, then the user is
returned to the menu without action being taken. HighLite keys are O
in <Ok> only.
YORN=PromptString
Places a single <Yes><No> dialog box before the user containing only
the string PromptString. If the user clicks on <Yes>, or presses
ENTER, then execution continues. If ESC is pressed or <No> is
clicked, then the user is returned to the menu without action being
taken. HighLite keys are Y in <Yes> and N in <No>.
SCROLLBOX=HelpFile,HeaderString
Presents user with an <Ok> scrolling mouse sensitive dialog box
containing up to 50 lines of user-defined help in the text file
HelpFile. Presents the lines directly following the first encounter
of HeaderString (so make it unique in the file, or the first
occurrence) up to the stop marker ### on a line by itself. User-
defined help file syntax is covered a few paragraphs from now with a
complete example. As an aside, the F1 key calls help in the same way
for any defined menu selection in the file PULLDWN.HLP. Again, this
is covered in detail later.
@MenuFile.DEF
Loads a the MenuFile[.DEF] menu definition file from the .DEF path.
This path is either:
1) The path to PULLDWN1.EXE -or-
2) The path set in the PULLDWN=Path environment variable, if
present. (Optional)
[.DEF] denotes that the extension is optional. Strongly recommended
that you follow syntax with .DEF to prevent confusion.
!AUTO!
A special set of instructions to be executed upon initial load of a
.DEF file. Like an AUTOEXEC.BAT for your .DEF files. See detail a
few pages from now on exact useage. Essentially you place any valid
.DEF commands under !AUTO! and they are executed on load, and then the
.DEF file resumes normally. You can only use this once in any .DEF
file, and the first occurence is the one that is used.
Any of these elements (except !AUTO!) can be used as many times as you like
under any title selection. The only exceptions are ?QuestionString and
LOADFILE, which are discussed in detail below. Working from the top of the
list, here are complete examples concerning how to use each command:
_____________________________________________________________________________
PullDown v2.30 Documentation Page 15
PASS=PassWord
- - - - - - -
Description:
PASS=PassWord
User is prompted for a password to continue. The selection halts
execution at the line PASS is encountered if the user cannot enter the
correct response or selects <Cancel> or presses ESC.
If you did not want just anyone running the Norton Utilities, then you
could protect the selection like this:
.
.
'0123456789012345
%Norton Utilities
HI=7
PASS=YourWord
+C:
+cd\nu
+nu
+pulldwn
.
.
For those of you who did not catch it, the HI=7 command was added to
demonstrate highlite of the U in Utilities above. Also, the user is now
asked for the password when selecting this item, and cannot proceed without
entering "YourWord" (no quotes, of course) correctly. To use multiple
passwords (unlimited) just place PASS=PassWord type statements under the
item repeatedly.
?QuestionString
- - - - - - - -
Descriptions:
?QuestionString
Shows the user PromptString and awaits input. If the user selects the
<Cancel> or presses ESC, the execution of the selection halts and the
user is returned to the menu.
*NOTICE TO v2.01 USERS*
&BatchCommand
No longer supported. Simply the same as using +
_____________________________________________________________________________
PullDown v2.30 Documentation Page 16
In the simplest case, let's say you want to prompt for the file to load
into MS WORD 5.0 when you use it. Change the MS Word 5.0 selection FROM
THIS:
.
.
%MS Word 5.0
+c:
+cd\word5
+word
+pulldwn
.
.
TO THIS:
.
.
%MS Word 5.0
?Enter file to load, [Enter] for None:
+c:
+cd\word5
+word %1
+pulldwn
.
.
NOTICE that the ONLY line to receive the %1 variable is the one that
invokes the program, WORD. To clarify the result, suppose that the user
enters MEMO as the response to the ? prompt. The resulting SHELL.BAT file,
(called in turn by TEMPPULL.BAT), used to actually start WORD in this case
will be:
c:
cd\word5
word MEMO
pulldwn
Similarly, if the user had entered nothing (just pressed ENTER alone), then
no file would be loaded. The resulting PULLDWN.BAT file would be:
c:
cd\word5
word
pulldwn
Which is what you had by default before you included the prompt. To use
multiple prompts, simply call ?QuestionString (Or LOADFILE - see next
section for LOADFILE details.) repeatedly. Up to 10 variables can be
passed, and are denoted IN ORDER OF ENTRANCE by %1, %2, %3 . . . %9, %0.
Let's take a moment to digress on the use of those %n variables for the
less expert users. Skip the following three paragraphs and examples if you
already know about the variables in batch files.
When you invoke a program from DOS, you can typically place a filename or
parameter following the command used to invoke it, and the software will
take some action. For example, when you start MS Windows you can specify a
program to run by placing it's name on the command line. Likewise, your
editor or Word Processing application does something similar in loading the
file specified. All the %1 through %0 symbols mean is "place that string
_____________________________________________________________________________
PullDown v2.30 Documentation Page 17
found on the command line in position X here" where X is the number following
the % symbol. (With 0 equal to number 10) Consider the following batch
file....
echo off
cls
echo The first thing on the command line is %1
echo The second is %2
echo and the third is %3
Suppose it is called TEST.BAT... if you typed this:
TEST Hello SecondString ThirdAndLast
you would get this back:
The first thing on the command line is Hello
The second is SecondString
and the third is ThirdAndLast
Further, notice what you get if you type:
TEST Hello
is only:
The first thing on the command line is Hello
The second is
and the third is
and this:
TEST First Second Third Fourth
is only:
The first thing on the command line is Hello
The second is SecondString
and the third is ThirdAndLast
The fourth was carried in, but not used. All PullDown does is places the
user's responses IN ORDER ENTERED on the command line. Using multiple
prompts for PullDown menu files is not ANY different from using them in
standard DOS batch files. i.e. ALL Batch Command Language extensions are
available to you. To learn more about DOS, the batch language, and how to
use it, try "Supercharging MS DOS" by Van Wolverton, Microsoft Press... it
is a GREAT book on the PC's abilities, and you will learn a great deal
reading it. Second, try BATCOM, a Shareware DOS Batch extender for more
power in your batch language applications. Let us turn back to PullDown
now, and go over an advanced example.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 18
Let's use a hypothetical example where you might want multiple prompts:
copying the contents of one disk to another disk where the disks are not
known in advance.
.
.
'0123456789012345678901
%Copy from Disk to Disk
HI=10
?Enter the SOURCE (First) Disk Letter:
?Enter TARGET Disk Letter:
%1
CD\
+XCOPY %1 %2 /S/M
pulldwn
.
.
Suppose the user responded A: and B: in order. The resulting batch file
is:
A:
CD\
XCOPY A: B: /S/M
pulldwn
[Look up the XCOPY command to understand why the switches /S/M are
included... essentially the disk is duplicated by "walking the tree" on the
source and creating corresponding subdirectories and files on the target]
Continuing with the example, let's add a second tier of query, which disk
to run CHKDSK on after the copy operation:
.
.
'0123456789012345678901
%Copy from Disk to Disk
HI=10
?Enter the SOURCE (First) Disk Letter:
?Enter TARGET Disk Letter:
+XCOPY %1 %2
' Clear the variables to get ready for the next question
?Enter the disk to run CHKDSK on after completion:
+CHKDSK %3
pulldwn
.
.
Assuming the user responds A: to the second question, and A: B: to the
first two, The TEMPPULL.BAT contents would result as:
XCOPY A: B:
CHKDSK A:
pulldwn
_____________________________________________________________________________
PullDown v2.30 Documentation Page 19
If the user did NOT respond to the second prompt and just pressed [ENTER]
above, having done everything else the same, the result would be in error
as:
XCOPY A:
CHKDSK A:
pulldwn
For this reason, you can FORCE the user to reply with non-blank input. Use
the keyword REQUIRED before prompts to force non-blank replies. If you
toggle REQUIRED on, and want to turn it off again, use NOTREQUIRED. You
definition to force entries would look like:
'0123456789012345678901
%Copy from Disk to Disk
HI=10
REQUIRED
?Enter the SOURCE (First) Disk Letter:
?Enter TARGET Disk Letter:
+XCOPY %1 %2
' Clear the variables to get ready for the next question
?Enter the disk to run CHKDSK on after completion:
+CHKDSK %3
pulldwn
.
.
If the user attempts to enter NOTHING, the system will stop, create a
dialog telling the user that input is required, and then reprompt for input
again. This same behavior is present in LOADFILE, which is very much like
?PromptString, only it presents the user with an elegant file loading
system instead of the blank prompt for input.
LOADFILE
- - - - -
Defintion:
LOADFILE=FileSpec,HeadingComment
Presents user with a professional style file load dialog, complete
with the ability to traverse the entire system, event handling, and
mouse support. The Heading Comment is optional, but encouraged. This
dialog returns to the command line the file name entered by the user.
A new file name can be entered at will, but the dialog will remind the
user that the file does not yet exist before continuing.
Syntax: LOADFILE=ValidPath[,HeadingTitle]
Where:
- ValidPath is a valid DOS path. Can contain wildcards *, ?
- If only wildcards are given, then the default directory is
used for the first showing of files.
- If you wish to load a specific file, then type the name
in inside the top FileSpec box. (1)
- Pressing ALT+N while inside the FileSpec box results in
nothing being passed to the program. (If the keyword
REQUIRED is in use, then the box will not permit this)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 20
- If you type a filename without an extension in the FileSpec
box, AND you passed a wildcard the pass before, then the
extension of the wildcard, if not *, is appended to the file-
name you enter.
- If you enter a filename that does not exist, then you will
be prompted for continuance. It is assumed that you will want
to force the filename, even though it does not yet exist, when
you are creating a new file altogether. Selecting NO leaves you
back where you started.
- An optional HeadingTitle is defined by simply placing a comma
followed by the desired heading text behing the path. The
heading may be up to 69 characters, and leading/trailing blanks
in the title are ignored. One leading and trailing space will
appear automatically at the top of the file load dialog box.
NOTES: The box will prompt you for RETRY on all DOS errors EXCEPT when you
enter a filename that does not exist. If you WANT to pass a nonexistant
filename to a program, it is permitted. For example, you might be creating
an entirely new document, and want to key the filename here, especially if
the input is required. (See REQUIRED keyword elsewhere in this manual.)
Also, when your focus of the dialog box (cursor) is on the top line (file
load specification) then it is optional to press ALT+N to load NO file
at all. [This will not be permitted if non-blank input is required.] The
ALT+N combination is effective ONLY when the cursor rests on that box. To
let you know this, the TagLine on the bottom of your screen will contain
explicit instructions concerning the availability of ALT+N when it is
available. Note that the default drive and directory are automatically
restored on exit, preventing the errors common to so many other file
load systems when they fail to reset the drive and directory on <Cancel>
exits!
The box looks (roughly) like this:
.................................
|--- The OPTIONAL HeadingTitle
V
------------- Your Heading Title Centered on Screen --------------
| ------------------------------------------- |
----->| FileSpec | C:\*.DOC | |
| | ------------------------------------------- |
| | |----------------------------------------------------------- |
| | | [-A-] filespec.doc | |
| | | [-B-] file.doc | |
| --->| | DIRNAME lad.doc (2) | |
| | | | WORD5 . | |
| | | | . . | |
| | | | . . | |
| | | | . . | |
| | | |----------------------------------------------------------| |
| | ->| <Load> <Cancel> (3) |
| | | |----------------------------------------------------------------|
| | |
| | |--- (3) The TagLine for LOAD or CANCEL. Unlike all other PullDown
| | dialog boxes, you cannot select these using ALT keys. You
| | must move the pointer on top of them using TAB if you do
| | not have a mouse. (Time constraint on design.)
| |
| |----(2) Directories in CAPS, filenames in lower case. Double click to
| select, single click to move to.
|
|--- (1) The FileSpec Box - Presents argument for files to load.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 21
EXAMPLES OF USING THE LOADFILE COMMAND
--------------------------------------
Using the same examples from ?QuestionString, so that easy comparison can
be made, we see that the commands are not really all that different in
nature.
In the simplest case, let's say you want to prompt for the file to load
into MS WORD 5.0 when you use it. Change the MS Word 5.0 selection FROM
THIS:
.
.
%MS Word 5.0
+c:
+cd\word5
+word
+pulldwn
.
.
TO THIS:
.
.
%MS Word 5.0
LOADFILE=*.DOC,Enter file to load into MS WORD:
+c:
+cd\word5
+word %1
+pulldwn
.
.
NOTICE that the ONLY line to receive the %1 variable is the one that
invokes the program, WORD. To clarify the result, suppose that the user
enters MEMO as the response to the ? prompt. The resulting SHELL.BAT file,
(called in turn by TEMPPULL.BAT), used to actually start WORD in this case
will be:
c:
cd\word5
word MEMO
pulldwn
Similarly, if the user had entered nothing (pressed ALT+N and REQUIRED was
not ON), then no file would be loaded. The resulting PULLDWN.BAT file
would be:
c:
cd\word5
word
pulldwn
Which is what you had by default before you included the prompt. As you
can see, the use of the command is simple, but the result is elegant. Now,
suppose you have users that typically need only copy one file at a time
from their WordPerfect directory to a disk for a co-worker. You might
write a selection as follows:
_____________________________________________________________________________
PullDown v2.30 Documentation Page 21
.
.
'0123456789012345567801234
%Copy Document File for Tom
HI=23
REQUIRED
LOADFILE=\WP51\*.DOC,Select file to Copy to A:
+echo off
+cls
+echo Place disk in drive A:, press any key when ready...
+pause > nul
+xcopy %1 a:
+pulldwn
.
.
And, for Tom, your selection might be:
.
.
'0123
%Copy Document File from A:
HI=0
REQUIRED
LOADFILE=A:\*.DOC,Select file to Copy from A:
+echo off
+cls
+echo Place disk in drive A:, press any key when ready...
+pause > nul
+xcopy %1 C:\WP51
+pulldwn
.
.
Mixing ?QuestionString and LOADFILE is permitted, but remember that
LOADFILE is actually passing parameters as well when you write the batch
commands. Here is a simple example:
.
.
'0123456789012345567801234
%Fomat a Disk and Copy a Document File to it
HI=18
REQUIRED
?Enter disk letter to format and copy to:
LOADFILE=\WP51\*.DOC,Select file to Copy to diskette:
+echo off
+cls
+echo Place disk in drive %1:, press any key when ready...
+pause > nul
+format %1 +xcopy %2 %1
+pulldwn
.
.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 22
Remember, PullDown does not have a way of knowing whether the variable
returned in %1 is in fact a valid drive. It is up to you to make sure that
users understand what to enter, and why the process (any process) might
fail. Now let's look at some of the other informative prompts you can give
to users.
OKBOX and YORN
- - - - - - - -
Descriptions:
OKBOX=PromptString
Places a single <Ok> dialog box before the user containing only the
string PromptString. If the user clicks on <Ok>, or presses ENTER,
then execution continues. If ESC is pressed, then the user is
returned to the menu without action being taken. HighLite keys are O
in <Ok> only.
YORN=PromptString
Places a single <Yes><No> dialog box before the user containing only
the string PromptString. If the user clicks on <Yes>, or presses
ENTER, then execution continues. If ESC is pressed or <No> is
clicked, then the user is returned to the menu without action being
taken. HighLite keys are Y in <Yes> and N in <No>.
These two commands are similar in that they pop a message you define to the
user. Execution of the selection is then in the user's hands, as selecting
<No> in the YORN type box, or pressing ESC in either box halts and returns
the user to the menus where s/he left off. To illustrate, suppose you
wanted the user to know that other applications such as the NotePad or
COMPRESS are available within PC Tools Deluxe...
.
.
'012345
%PC Tools Deluxe
HI=3
OKBOX=Select APPLICATIONS in PCSHELL for more Utilities
+c:
+cd\pctools
+psshell
+pulldwn
.
.
The user would see something like this on the screen.... (Only it looks
much better)
-----------------------------------------------------
| |
| Select APPLICATIONS in PCSHELL for more Utilities |
| |
|-----------------------------------------------------|
| <Ok> |
-----------------------------------------------------
_____________________________________________________________________________
PullDown v2.30 Documentation Page 23
In the case of YORN, the only difference is the bottom line. For example,
including the following:
.
.
'012345
%PC Tools Deluxe
HI=3
YORN=Select APPLICATIONS in PCSHELL for more Utilities
+c:
+cd\pctools
+psshell
+pulldwn
.
.
Would produce this style box:
-----------------------------------------------------
| |
| Select APPLICATIONS in PCSHELL for more Utilities |
| |
|-----------------------------------------------------|
| <Yes> <No> |
-----------------------------------------------------
Of course, YORN is more appropriate for situations where confirmation is
requested. For example, if you wanted to create you own EXIT TO DOS
selection, you might add the following to your growing .DEF file:
.
.
DEF
%Exit
%Exit to DOS
YORN=Are you sure you want to Exit?
PASS=YourPass
+echo off
+cls
+echo Type PULLDWN [Enter] to Start the Menu Shell
' Notice that NOT calling PULLDWN on the end exits to DOS
%Load the default PULLDWN.DEF file
@PULLDWN.DEF
When the user selects "Exit to DOS", they will be prompted to be sure that
this is what they want to do, and then required to enter the password
"YourPass" to proceed with the operation. The second portion of this
example demonstrates how to load a menu definition file from a menuselection,
which is discussed at length below.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 24
@MenuFile.DEF
- - - - - - -
Description:
@MenuFile.DEF
Loads a the MenuFile[.DEF] menu definition file from the .DEF path.
This path is either:
1) The path to PULLDWN1.EXE -or-
2) The path set in the PULLDWN=Path environment variable, if
present. (Optional)
[.DEF] denotes that the extension is optional. Strongly recommended
that you follow syntax with .DEF to prevent confusion.
Branching to another menu file is the feature of PullDown permitting you to
define unlimited submenus for your system. All that happens is PullDown
loads the file you specify after the @ symbol key. If the file is not
found, then the user is prompted for a valid file. If the second file is
not found PullDown exits to DOS displaying help and where to call for
technical support. This option is amply demonstrated above, and should
prove to be a valuable tool as you build your menu tree. Of course, you
don't have to use it, but it is worthwhile to split large chunks into
different files if for no other reason to optimize load time of a given
.DEF file. (See APPENDIX E, PERFORMANCE OPTIMIZATION for details on why
this is true.) As a final note on @, you can load PULLDWN.DEF at ANY time
by clicking on the word PullDown at the bottom tag line, or pressing F9.
This was added in the event you define a submenu you call and forget to
allow an exit back to the main menu. (It happens!)
Finally, a special .DEF command allows you to automatically execute a set
of commands on entry to any particular .DEF file. It is !AUTO! and closely
corresponds to the standard %TitleString behavior, without a title.
!AUTO!
- - - -
A special method of automatically executing commands on entry to a .DEF
menu is provided via the keyword !AUTO!. Syntax is:
!AUTO!
' Any valid .DEF commands
.
.
NOTES: - !AUTO! must be capitalized, and can occur ANYWHERE
within the definition, even at the end of the file.
- Only ONE occurence is permitted, all subsequent
calls are ignored completely.
- MAXDEFS=nn *still* must be the first line in the
.DEF file to operate properly. (See OPTIMIZATION in
the appendix)
- Command line parameter IGNOREAUTO causes *all* !AUTO!
commands to be ignored completely, just as if the system
had just loaded the .DEF file prior.
- Behavior is this:
* Executed ONCE when loaded
* Executed EVERY TIME you re-enter this menu, unless
the IGNOREAUTO keyword is used on the command line.
e.g. you enter it, select something, and then resume.
You will get the !AUTO! sequence again.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 25
- Will function properly with RESUME toggled OFF, but
* If resume is OFF when found, resume is toggled ON to
avoid an infinite loop.
* If the resume file [PULLRES.FIL] is deleted, the system
has no way of knowing that the menu was just called.
Don't delete the resume file with !AUTO! commands!
- Selecting a <Cancel> or <No> option, or pressing [ESC] while
viewing an <Ok> dialog box (except a HELP box) results in
that ONE TIME abort of the automatic menu selection. The
menu selection will be executed the next time you call that
.DEF file. Normally, the !AUTO! commands are executed, and
then you are sent back to the same .DEF menu definition, but
the !AUTO! selection is NOT executed again.
- Debugging using a standard selection and subsequent
conversion to !AUTO! is strongly reccomended.
DEFINING USER HELP SCREENS
==========================
*USERS OF v2.17 or OLDER TAKE NOTE: Syntax has changed*
It is worthwhile to detour at this point to a feature inherent within the
menu system before explaining fully the SCROLLBOX= command. PullDown can
call upon defined help within external text files such as the samples
contained within the package SAMPLE.HLP, and the main help system file
PULLDWN.HLP. The two are syntactically identical, but serve distinct
purposes. In short, PULLDWN.HLP is the *ONLY* reserved .HLP file name
within the system, and it holds the help screen text for *ALL* defined menu
selections in any .DEF file you might use. All others are defined by you,
and called individually in your SCROLLBOX= commands. First, let's suppose
that you wanted to define a help screen that the user would see if s/he
pressed/clicked [F1] from within your menu while the bar was on "Lotus 1-2-
3". You would edit the PULLDWN.HLP file to include something like this:
.
.
%Lotus 1-2-3
The world's leading spreadsheet, which has
about 5,000,000 registered copies sold, with
roughly that same number bootlegged.
###
.
.
And, if the user pressed or clicked F1, then the screen would show the
following type of dialog box to the user:
------------------- Lotus 1-2-3 ---------------------
|
| The world's leading spreadsheet, which has +
| about 5,000,000 registered copies sold, with +
| roughly that same number bootlegged. +
|
|-----------------------------------------------------|
| <Ok> |
-----------------------------------------------------
_____________________________________________________________________________
PullDown v2.30 Documentation Page 26
Upon pressing [Enter], clicking <Ok>, pressing ALT+O, or ALT followed by O
and [ENTER], the box is cleared. This box is scrollable, can contain up to
50 lines of help, and can accommodate up to 69 characters in width. The
box is self-sized about your text, and centered on the screen for you
automatically. Of course, the box on screen looks much better than this
one, but you can gather that this is a powerful and useful feature. Some
rules apply when you define user help screens, and in summary they are:
1) PullDown will read lines UNTIL *one* of the following conditions is
met:
a) The End of Help marker, ###, is encountered ALONE on a line
b) 50 lines are read into memory
c) The end of the file is reached
2) Lines that are too long (up to 100 char) are truncated
3) The header you define in SCROLLBOX= or the title in the menu system
should occur at the beginning of the help screen FIRST in the file.
Otherwise, PullDown stops and reads the text following the first found
header match. (See sample of this condition below, this includes
comments in this version.)
4) A memory constraint is not anticipated, as memory is allocated for
these lines when the program starts.
5) Embedded blanks within the SCROLLBOX=HelpFile,HeaderString are not
permitted. i.e. follow the = with the HelpFile, string. To conclude, you
can pop a scrolling box like this with defined contents from your custom
filename as follows:
SCROLLBOX=HelpFile,HeaderString
- - - - - - - - - - - - - - - -
Where:
HelpFile is any ASCII file, and
HeaderString is the first unique occurrence of the header in the file
followed by a help screen set of lines, ended by a ### on a single
line.
Full Description:
SCROLLBOX=HelpFile,HeaderString
Presents user with an <Ok> scrolling mouse sensitive dialog box
containing up to 50 lines of user-defined help in the text file
HelpFile. Presents the lines directly following the first encounter
of HeaderString (so make it unique in the file, or the first
occurrence) up to the stop marker ### on a line by itself. User-
defined help file syntax is covered a few paragraphs from now with a
complete example. As an aside, the F1 key calls help in the same way
for any defined menu selection in the file PULLDWN.HLP.
An example might be popping a multiple line notice giving the user specific
directions. Building on the prior example for the Norton Utilities,
suppose you wanted to tell the user that undeleting a file is supported,
and where to call in your organization to obtain help if s/he cannot
undelete it automatically:
_____________________________________________________________________________
PullDown v2.30 Documentation Page 27
.
.
'012345
%Undelete a File
HI=0
SCROLLBOX=MYHELP.HLP,Undelete a File
YORN=Do you want to continue?
?Enter file to undelete:
+UNDELETE %1
+pulldwn
.
.
And, within MYHELP.HLP you had placed:
.
.
%Undelete a File
1) Attempt to use this automatic utility first to recover your file
2) If this fails, then DO NOTHING MORE, but call Tom Guru in MIS at
x4567 and ask for assistance. If Tom is not in and you get his
terse voice mail, then call Shelly at x5678.
3) Have a nice day.
###
.
.
The user would be presented first with your help box, asked if they really
want to continue, and finally prompted for the filename to recover. You
can see more examples of this in ADVANCED.DEF and SAMPLE.HLP.
DEFINING HELP SCREENS
- - - - - - - - - - -
Help files usually have the extension .HLP on them, and are pure text files
like the definition files. As shown above, the syntax to call up a help
screen is simple. In general, the format for each screen is:
%Unique HeaderString
Help Text
.
.
.
.
###
Rules for use:
1) Lines may be up to 69 characters wide. This limit is actually defined
by the width of the screen (80) less the number of characters displayed for
the surrounding boxes and shadow(s).
2) Up to 50 lines excluding the header line are permitted. This limit is
arbitrary and can be raised if you have need.
3) The %HeaderString *MUST* be the first occurrence of the header within
the .HLP file, as PullDown scans for it and then displays the following
lines as help. If you get unexpected text on the screen, it is likely that
_____________________________________________________________________________
PullDown v2.30 Documentation Page 28
you either did not make the header unique, or that there is another
occurrence of the same string before you expected it for the help screen.
4) For ALL >menu selections< F1 help screens in ALL .DEF files, the file to
use is PULLDWN.HLP - and PullDown expects it in the same subdirectory as
PULLDWN1.EXE (C:\MENU unless you installed the system somewhere else on
your PC... see INSTALLATION).
5) SCROLLBOX= statements may call upon any filename, any number of times.
6) Lines with a leading ' are comments, BUT the contents are scanned for
the unique header string.
Ample examples of defining user help are provided in the preceding
sections, but let's take a close look at designing your own system in total
with help for each menu selection here. Suppose you had a definition file
with these contents:
DEF
%Applications
%Lotus 1-2-3
+C:
+cd\lotus
+123
+pulldwn
%Harvard Graphics
+c:
+cd\harvard
+hg
+pulldwn
%MS Word 5.0
+c:
+cd\word5
+word
+pulldwn
' Second TOP BAR is Utilities.... (This is a comment ignored by
PullDown)
DEF
%Utilities
%Norton Utilities
+C:
+cd\nu
+nu +pulldwn
%PC Tools Deluxe
+c:
+cd\pctools
+psshell
+pulldwn
%FastBack Plus
+c:
+cd\fastback
+fb
+pulldwn
_____________________________________________________________________________
PullDown v2.30 Documentation Page 29
%Format Diskette in Drive A:
+format a:
+pulldwn
It is suggested that you take these steps to create help screens for use
within the F1 HELP screens for your .DEF files, if desired:
1) Load the .DEF file into your editor or word processor.
2) Clip out all but the Title definitions (each line contents
following the % symbols) without the leading % sign.
3) Set up a ruler to show where character 69 is
4) Write you help screens, ending each with termination marker ###
5) Save the file as PULLDWN.HLP, pure text.
6) Repeat for each .DEF file in your system, appending the file as
needed.
TIP: Keep the text "balanced" within an imaginary box on screen as you
type. This will prevent an unprofessional appearance to the help screens
when they are displayed.
Your help file, in part, might look like this:
' Applications Help
' Ruler:
' MAXIMUM >>>
'------------------------------------------------------------------|
%Lotus 1-2-3
Leading spreadsheet. Use this option to edit the
monthly operating report in the file RPTFIL.WK1.
Print the report using ALT+P, save with ALT+S,
then exit using /QY.
###
%Harvard Graphics
Use this software to make the charts for the
monthly operating and marketing reports.
Load the charts one at a time, and key the
new values. When they are finished, show
them to Mr. Jones, who will tell you what
to change this month.
###
%MS Word 5.0
Use word processor when you need to write long
letters to coworkers or clients.
###
.
.
and so on....
As noted in prior sections, each help text content definition is displayed
in a dialog box that users can scroll through. Users press [ENTER], [ESC]
or click on <Ok> to clear the box.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 30
USING THE SAA INTERFACE
___________________________________________________________________________
USING THE KEYBOARD
==================
The first thing you see on invocation of the menu system is the PullDown
front interface. A menu is initialized for you and rolled on to the
screen. The HiLite HotKeys appear in a different color from the rest, and
if pressed move the HiLite menu bar to the selection. If you then press
[ENTER] the item is selected and the commands you defined in the
.DEFinition file are executed. To access the selection directly, press and
hold the ALT key, followed by the HiLite key of the selection desired.
This is the same as pressing [ENTER] with the HiLite bar on that same
selection. To access any function key, simply press it and the action is
taken. That is all there is to the standard interface. On to Dialog
Boxes.
Dialog Boxes appear when you invoke them, and for the [F2=Options]
[Options] [Settings...] setup dialog box. A couple of concepts need to be
covered here for the less experienced user, and so again if you are a real
"power" user skip ahead three or four paragraphs past the examples to save
time. For the majority of others, we will take a look at dialog box
elements, how the keyboard modifies each one, how to move around, and
finally how to select options.
Dialog boxes consist of one or more elements. An element is simply a type
of dialog box interface that behaves in a certain way. Let's start with
the most basic, the command button.
A command button is bracketed by less than and greater than symbols on your
screen. An example is the <Ok> dialog box you saw earlier in the
documentation that looked like this:
-----------------------------------------------------
| |
| This is an <Ok> Dialog Box Example. |
| |
|-----------------------------------------------------|
| <Ok> |
-----------------------------------------------------
On your screen the cursor would rest on the O in OK. Where the cursor
sits, that is called the current focus of the dialog box. If you press
[ENTER] on a command button where the focus lies, that is the selection you
make. To move the focus, you press the [TAB] key. For example, the
<Yes><No> dialog looks like:
-----------------------------------------------------
| |
| This is a <Yes><No> Dialog Box Example. |
| |
|-----------------------------------------------------|
| <Yes> <No> |
-----------------------------------------------------
and the focus (cursor) rests on the Y in Yes at first. If you pressed
[ENTER] you would be selecting <Yes>. Pressing [TAB] moves the focus to
<No>, and pressing [ENTER] then would be answering <No>. By the way,
unless otherwise noted, [ESC] is like pressing <No> or <Cancel>. Besides
_____________________________________________________________________________
PullDown v2.30 Documentation Page 31
[TAB] there is another way to move the focus in dialog boxes. If you press
and release the [ALT] key, you will see HiLite keys lit on the screen.
Pressing the HiLite key letters moves you around in the dialog box. For
example, the HiLite keys in the <Yes><No> dialog box are Y and N, just as
you would expect. Finally, if you pressed and held the [ALT] key down,
followed by the HiLite letter, you would select the option just as if the
focus rested upon it and you pressed [ENTER]. These basic movement
principles hold for ALL dialog boxes, no matter how complex. Now let's
examine the elements you will encounter in the SETUP options of PullDown
and how to navigate them. The exact meaning of the options is discussed in
the section coming later on CONFIGURING THE MENU SYSTEM.
Option Button Clusters look like this:
() Option One of Three < Current selection
( ) Option Two
( ) Option Three
When the focus is on this cluster, the cursor will be on the selected
option with the burger dot. To change options selected, press the [Up] or
[Down] arrows. Press [TAB] to move on to another element, or press [ALT]
and release it to activate the HiLite HotKeys. Check Boxes have this
appearance on screen, and are either ON or OFF, depending upon whether or
not they contain an X. (In other interfaces this could be a check mark,
dot, or other character that is not a blank space)
[X] Selected Option
and one that is inactive looks like this:
[ ] Selected Option
Move the focus in one of the manners described above, that is with either
the [TAB] key or the HiLite key presses. To toggle the option status while
in the box, press the [SPACEBAR] key.
Finally, a text box is one that takes user input, like the box that is
popped to screen when you use the ?PromptString command. The focus
initially rests on one of two places, depending upon whether something is
already in the box when you enter it. If the box is empty, the cursor
rests on the left margin of the box and is ready for your input. If the
box contains something already, the text will be in a different color from
the background and the cursor will be on the last character of the string
contained in the box. At that point, if you want to replace the contents
entirely just start typing. The old string is erased and you start anew.
If you want to simply edit that string, press the LEFT arrow key. Then all
standard editing keys take effect. i.e. [INSert], [DELete], and other edit
keys all have meaning just like they do in your word processor. To accept
the input AND exit press [ENTER]. To move on to another element press
[TAB].
As a final note, when using the color selection palette move around with
the arrow keys, accept selection with [ENTER] and cancel with [ESC].
USING THE MOUSE
===============
Using the mouse with dialog boxes is the most natural way to select options
and change the focus of the dialog. To select command buttons like <Ok> or
<Cancel> just click and release the left mouse button on them. The same
_____________________________________________________________________________
PullDown v2.30 Documentation Page 32
holds true for the SAA front end, the [Function] keys on the bottom row,
and the word PullDown in the lower left, which loads the default
PULLDWN.DEF menu regardless of your current menu load status. (The key
equivalent is [F9] for selection of the default menu file.) To change
option's status AND focus, click on the desired selection, and to change
focus to text input boxes, just click the left button on them. The SAA was
designed with the mouse in mind, and you will find it the most natural
extension of the keyboard allowing speed and accuracy of selection in a
very easy to comprehend interface.
CONFIGURING THE MENU SYSTEM OPTIONS
___________________________________________________________________________
Pressing or clicking [F2=Options] on the bottom row of the screen invokes
PullDown's setup system. The menus are, of course, PullDown in style and
reflect the exact colors of the system as they will appear on exit back to
the menu shell. The first set of color options are changed by selecting
each in turn and reconfiguring the colors with the sample box that pops up
on the right side of the screen. Click or select with the keyboard the
color you want for each element, or press [ESC] to back out. The menus
will instantly reflect your changes, and by iterating through this process
you will arrive at your own color configuration. If you are a registered
user, you may save the colors as the defaults and exit the setup system by
pressing [F10], clicking the [F10=Save & Exit] option on the bottom row, or
lastly by selecting the SAVE option from the EXIT pulldown menu on the far
right. You may abort at any time. If you are an unregistered user, the
SAVE of ONLY the colors is withheld. ALL OTHER OPTIONS FUNCTION NORMALLY
even if you never register the system. Let's go over the other options
available under the second pulldown menu and what each means.
First selection, second menu, SETUP options, brings a large dialog box to
the screen. Each option cluster is clearly marked, and will contain
rational defaults. The box looks roughly like this in layout, and each
cluster is numbered below for reference as the options are explained below:
_____________________________________________________________________________
PullDown v2.30 Documentation Page 33
() Normal Mouse () Normal Screen Mode (25 Lines)
( ) Fast Mouse -> ( ) 43 Line EGA/VGA Mode
-> ( ) Very Fast Mouse | ( ) 50 Line VGA Mode
| ( ) No Mouse Support | [X] Show Blanker Flag
| |
| |
| Cluster Two, with check Box, Option 2
Cluster One, Mouse Options. Option 1
And the lower section has two check boxes and two text boxes in it:
[X] Turn NumLock OFF on Entry to Menu System <- Check box, Option 3
[X] Resume Status of Menus on Entry <- Check box, Option 4
-----------------------------
----> Number of Minutes to Screen Blank | |
| -----------------------------
| -----------------------------
| --> Password Required to Modify Options | |
| | -----------------------------
| |
| Password to get to [F2] options, Option 6
| -----------------------------
| --> Password Required to Exit to DOS | |
| | -----------------------------
| |
| Password to exit to DOS, Option 7.
|
Screen Blanker Countdown Timer Option 5.
The options, and their impact on the menu system are:
1) The mouse speed of movement across the screen as you move the
device is defined in units called Mickeys. (No kidding!) PullDown
let's you select your speed to taste from normal to very very fast.
The second box, the very fast option, is likely your best bet in 43/50
line mode as you can get around that big screen more quickly. The
final option disables the mouse completely (makes it invisible,
really) for those who hate rodents or have MS incompatible hardware
that they want disabled.
2) The number of screen lines is limited by the type of display
adapter you have. PullDown automatically detects your monitor type,
and will not permit you to select a mode that is unavailable to you.
This option also limits the number of %Titles you can have DOWN the
page, as the number down the page is equal to the number of screen
rows less four (top line, second line for box, lower line for box, and
shadow... four). If you select 50 line mode, load a 46 line menu file
definition, and then select 25 lines, the menu system will refuse to
change screen modes. If this happens, load a smaller menu file and
then change back to a lower number of screen rows. Selecting the 50
line mode on EGA systems results in the 43 line mode being invoked.
Finally, SOME clone systems MAY give PullDown a "false" impression of
the type of monitor and video card installed within the system. If
this happens, then the menu system will refuse to continue and issue a
detailed fatal error message instructing you to call for technical
_____________________________________________________________________________
PullDown v2.30 Documentation Page 34
support. The check box allows you to turn the screen blanker flag
that rolls across the screen OFF as you wish.
3) PullDown can turn off that annoying NumLock key on startup. Toggle
this option ON to have PullDown do this each time it starts.
4) PullDown can resume the menus exactly where you left them when you
selected an option. This is the default setting, and if you turn it
OFF, then the system will load PULLDWN.DEF and show the first
selection of the first menu when you enter the shell. This option
will be toggled ON for you if you use !AUTO! commands.
5) Acceptable minute to blank settings are 1-99. Values less than one
are returned as the default value of three minutes, as are values
greater than 99 or less than zero.
6) A password can be required to protect option settings from children
who enjoy changing colors or users you do not want to have access to
the options.
7) This password, if entered, is required to exit to DOS using the
[ESC] key. CAUTION: Don't set a password to modify options and a
password to exit to DOS and then forget them. If this happens, and
you defined passwords as required to exit from all available
selections, you can get trapped in the shell! [See Appendix A,
Troubleshooting, if this happens to you!]
The other options available in the OPTIONS pulldown are Registration, How
to Register, and Return Colors to Default Values. The latter option just
returns the colors to something sane if you get too far gone (!) when
setting the colors up, and the others are self-explanatory. Essentially
you need to send the $20 registration fee for a matching registered name
and number if you want to register the product. The number you need is
based upon a non-linear algorithm of the ASCII encrypted values of your
registered name, as you might suspect. Lines under a certain length are
not even acceptable, and repeated attempts to register without a valid
MicroDynamics issued number will invariably fail. When it comes time to
register your copy, you can start the menu system with the word REGISTER
behind it to obtain the registration system screen without going all the
way into the SETUP screens.
Finally, the EXIT option contains the two options SAVE & EXIT or ABORT.
Selecting ABORT cancels all changes EXCEPT registration. Registration is
final after the registration system is run once. (As you might suspect,
the registered name and number are saved in a double-encrypted binary
format in PULLDWN.CNF. Deleting that file voids your registration.)
COMMAND LINE PARAMETERS
___________________________________________________________________________
Formal PullDown Syntax is:
PULLDWN [DEBUG] [CANCEL] [HELP] [IGNOREAUTO]
Where:
DEBUG - Causes PullDown to display stages of messages concerning the
activities carried on startup. Used when the program locks a clone
system for an unknown reason to debug remote. Also displays extensive
pathing debug help when multiple paths are in use.
CANCEL - Erases the PULLRES.FIL file containing the resume status of
_____________________________________________________________________________
PullDown v2.30 Documentation Page 35
the menu shell, thus cancelling the resume feature on startup. Used
when it is known that the .DEF file that was loaded on exit no longer
exists. Specifically, PullDown creates this file each time you exit
when the [ ] Resume Status box is checked ON, and the contents of that
file define which menu file to load (the one you were in when you
selected an option) and the specific item your cursor was on when you
left the system.
REGISTER - Invokes the command line registration system. Used when
registering the product. See the following section for details on how
to obtain your registration number.
HELP - Displays a help screen concerning DEBUG and CANCEL
IGNOREAUTO - Forces the commands under any !AUTO! selection to be
ignroed. Use if you get trapped in a loop, or wish not to have the
commands execute on load.
TECHNICAL SUPPORT & REGISTRATIONS
___________________________________________________________________________
Even unregistered users are welcome to ask any and all questions, provide
suggestions, and test BETA copies of the software without charge. You can
contact MicroDynamics on the follow electronic systems via modem:
* CompuServe ID 72010,2546
* RunWay BBS (215)-623-6203 8n1
- 2400-14,400 HST 3 Nodes, No Fee for Technical support or to download
the latest versions
- This BBS is subscription only for general downloads. Enter
conference number FIVE (5) for MicroDynamics Technical Support and new
offerings, including all BETA versions for general download. There is
no charge at all to access the technical support SIG and any files
contained therein.
- Leave mail for SAM HORTON in any conference for help, preferably the
MAIN or tech support conference #5. PLEASE do not leave messages to
the Sysop (although they too will be answered quickly) as
MicroDynamics is NOT the owner/sysop of the system.
* DelChes BBS (215)-363-6625 8n1
- Public Node, no fee required, mail-in registration a MUST in advance
- All latest posted under MicroDynamics SIG. Select from main menu
these keystrokes to enter the conference:
MSCS
* EXEC-PC
- Leave E-MAIL to Sam Horton
- Answer not guaranteed in under one week
- Latest release always posted on this premier BBS
* GEnie
- Support not available as of 10/1/90
- EMail still online S.HORTON1, but not checked routinely
_____________________________________________________________________________
PullDown v2.30 Documentation Page 36
BY MAIL:
MicroDynamics Development
1445 Mensch Lane
Gilbertsville, PA 19525
* IF YOU REQUIRE AN INVOICE, WE WILL BE HAPPY TO BILL YOUR ORGANIZATION.
SIMPLY WRITE AND REQUEST THIS SERVICE. NO CHARGE. *
To register, print and return the form contained in the disk file
REGFORM.DOC. If you are unfamiliar with this process, type the following
at the DOS prompt, assuming that you used the defaults to install the
system as described earlier in INSTALLATION:
C:
CD\MENU
TYPE REGFORM.DOC > PRN
*IF* you know your printer is on a serial port on COM1: (unlikely, but
check if you are uncertain), type:
C:
CD\MENU
TYPE REGFORM.DOC > COM1:
Turnaround is almost always less than one week, (often one day) and if you
provide a valid CIS ID, or are an EXEC-PC subscriber, then you will get
your registration number electronically. Diskettes are mailed at extra
cost. The reason for the charge is simple: diskettes, stamps, mailers, and
the labor cost money. You can save the charge by picking up the latest
version on the tech support BBS or CIS electronically. MAJOR upgrades are
always announced and chances are excellent you will receive a letter
notifying you of their availability. Upgrade diskettes, again, are mailed
for a fee. IF you find a virus infected copy, your diskette is FREE when
you disclose the source of the file you obtained.
Your registration number will be valid for all future releases, unless a
code change is required to support a smaller faster link library. IF the
code changes, you will be sent a new number in the mail upon release. In
any case, if you upgrade an existing copy, the registration upgrade is
automatic. Back up your PULLDWN.CNF file when you register, as this is the
key file containing your user information.
VOICE:
Available shortly to registered users, and presently available to
registered consultants and dealer sites.
MULTIPLE SITE COPIES:
Number of Copies Price Per Copy in Range
---------------- -----------------------
1-20 $20
21-50 $15
> 51 $10
LANs registered by number of nodes on system with access to the menu shell
in the same structure. Technical support is presumed to be first handled
on site, and second through MicroDynamics for multiple site copies.
OUTSIDE THE USA? See APPENDIX C: FOREIGN VERSIONS/TECHNICAL SUPPORT
OVERSEAS below.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 37
CONSULTANT'S DEALERSHIPS
___________________________________________________________________________
Several consultants worldwide are presently installing PullDown for clients
to differentiate themselves from the pack using the old "A" "B" "C" or
rolling one style menus. The arrangement involves significant margin for
the consultant, and increased customer satisfaction. Please call or write
for details if you are interested in joining the growing list of authorized
dealers.
APPENDIX A: TROUBLESHOOTING GUIDE
___________________________________________________________________________
As with all software, you may have trouble configuring PullDown to suit
your needs. The following guide is designed to get you through the vast
majority of problems you might encounter, and the design of the product
often includes a full help screen describing critical conditions that cause
failures. However, there are some things the software is not presently
capable of trapping as errors, and you will find this section helpful when
you encounter one.
PROBLEM: Option is selected and nothing happens--you just return to the
menu shell without the application starting as expected.
CAUSES AND SOLUTIONS:
1) Batch contents are in error. Examine the option in the .DEF file
loaded for:
a) Spelling errors and typos
b) Erroneous contents... e.g. wrong directory for startup, bad
drive letter(s), incorrect syntax.
c) Commented out contents. Leading ' characters cause the line
to be ignored as a comment.
TIP: If you cannot determine what the problem is in short order, try
modifying your batch definition for debugging as follows:
Original Contents:
.
.
?Enter File to Load:
echo off
cls cd\word5
word %1
pulldwn
.
.
___________________________________________________________________________
PullDown v2.30 Documentation Page 38
Suggested contents to "debug" the definition:
.
.
?Enter File to Load:
echo ON
cls
cd\word5
pause
word %1
pause
pulldwn
pause
.
.
Then execute the selection again. This time you will see ALL DOS
errors and each command followed by the PAUSE message "Press Any Key
to Continue". Look for your errors and correct them as required, then
when you have the selection working remove the pause commands and
change echo ON to echo OFF so that the commands are no longer visible
as they execute. A short guide to debugging in general follows below.
What to look for as the selection runs:
a) After the cd\word5 command, see if DOS says "Invalid
Directory". If so, fix the path in your command to match the
path to WORD.
b) After the word %1 command, see if DOS says "Bad Command or
Filename". If so, change the command to the correct name of the
program. (May happen if you determine (a) above is the problem.)
c) After the pulldwn command, the menu shell should start. If
not, likely DOS returned "Bad Command or Filename" -- if so
modify your PATH as described in INSTALLATION.
2) You started the menu shell using PULLDWN1 instead of PULLDWN. Use
the batch file PULLDWN to start the shell, or the temporary files are
never executed. You will know if this is the problem as the shell
will just exit to DOS when you select anything at all and never
restart.
2a) Start the shell using PULLDWN1 as the command, and then check the
contents of SHELL.BAT to make sure that you are getting the expected
contents. If you are, and the system is supposed to pass a command
line variable, then check TEMPPULL.BAT to make certain the command
line parameters are going through. Remember, it is up to you, the
batch file author, to trap bad command line parameters, as PullDown
has no way of knowing (nor passing to a batch file) that a NUL input
is not valid. (Will be supported if requested... e.g. a REQUIRED
keyword.)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 39
3) All runs well, but you cannot get back to the line containing
PULLDWN to restart the menu shell.... caused by a program that "clears
the stack" on exit, thus erasing the batch file from memory. To
circumvent this, modify your batch contents to use a command shell to
invoke the program ONLY. e.g. modify the sample above to look like
this:
.
.
?Enter File to Load:
echo off
cls
cd\word5
command/c word %1
pulldwn
.
.
This should solve the problem. An alternative is to compile your
batch files using a utility from PC Mag called BAT2EXE. A discussion
of its usefulness is beyond our scope here, but if you are an advanced
user you should check that utility out. You can get a copy on just
about any major BBS in the country, or on CompuServe in the PCMAGNET
forum.
PROBLEM: System locks up or "freezes" permanently.
CAUSES AND SOLUTIONS:
1) If you are running ANY TSR (Terminate and Stay Resident Programs,
like SideKick, PC3270, CXI, PCOX, PCSHELL in TSR mode.) uninstall it
and retry the menu shell. If it starts, reload each TSR in order
until the conflict arises again. While PullDown is known to be well-
behaved and stable on IBM hardware, there are clone BIOS chips out
there that will cause conflict when certain TSRs are running. [If
this is too technical, and you suspect the problem on your system,
consult an expert or call for technical support... we will be glad you
help.]
2) If you are using PC3270 or 3270 as a TSR gateway to your mainframe,
invoke it only with the T command line option. Using the R option and
invoking the HotKey over PullDown will cause a crash every time.
Suffice it to say IBM did a less than perfect job with the keyboard
handling in the 3270 program. If you know you have this problem,
simply never pop up the 3270 as a TSR while inside the shell. A
future version of PullDown may solve this problem for you, but it
remains to be seen. The problem is also specific to some but not all
genuine IBM PS/2's.
3) If all fails and the system locks continually, try the DEBUG
command line parameter, note the last message on the screen after the
crash and report circumstances to MicroDynamics. There are some AMI
BIOS chips in some 80286 clones KNOWN to lock every time PullDown is
run.
If you call MicroDynamics technical support with a problem like this,
please have the following handy:
- BIOS manufacturer and date (shown on boot up)
- Contents of CONFIG.SYS (in C:\ most likely)
- Contents of AUTOEXEC.BAT (also in C:\)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 40
4) Zenith Z series PC clones are notorious for being incompatible
beasts. PullDown will undoubtedly crash on these machines, and the
Zenith video ROM debugger will appear on the screen. If this happens,
it means you cannot use PullDown on your computer.
PROBLEM: Help system or main menu system displays unexpected or bizarre
results.
CAUSES AND SOLUTIONS:
1) You used a word processor to save the file without converting it to
pure text. Reopen the file with the same word processor used to
create the file in error, and then resave it as text. See
INTRODUCTION section.
2) .DEF file is corrupt. Check to ensure nothing is wrong with it,
and that it is in fact pure text.
3) You have a string occurrence of the exact menu title or search
string used to define the help header BEFORE the header itself.
Remove the duplicate occurrence of the help header, or change the
header to be unique within the file.
4) You have an exact match of menu titles within the system. Each
%TitleString in this version must be unique, just as headers in help
files need be unique.
5) You were using an older version of PullDown, less than 2.30, and
your syntax for the help headings has not yet been updated. Add a
leading % symbol before each heading to correct.
6) You included leading blanks in your %HeaderString, to match the
leading blanks included in the .DEF file call. This is not needed.
Under NO circumstances are leading blanks permitted in the
%HeadingString. (Saves memory, easier to search, easier to display)
PROBLEM: Mouse intermittently disappears, but reappears after you select F2
options and reenter the menu system, or the mouse does not select correctly
when clicked on a menu item.
CAUSES AND SOLUTIONS:
1) Your IBM mouse driver is outdated. Get an update from a current
copy of WINDOWS or directly from IBM. Versions dated 1897 or earlier
do this routinely in high resolution screen modes on IBM PS/2s.
2) You are using a Logitech C7 mouse. There is an acknowledged bug in
the mouse... to see if this is the case, gently shake the mouse, then
try again. If this works, call Logitech for a driver upgrade, or a
new mouse.
3) You are running an MS 200 DPI mouse in emulated graphics mode.
When you do this, you must select a pixel within a menu item exactly
to get the system to function correctly. PullDown is simply not
designed anticipating a character mode emulated in 200 DPI graphics!
Use the system in text mode to avoid the problem, or stick to the
keyboard. A future version may address this problem directly and
solve it.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 41
PROBLEM: You are using !AUTO! and the commands execute forever.
CAUSES AND SOLUTIONS:
1) Your commands under !AUTO! deleted the file PULRES.FIL. Since
PullDown only knows that you already performed the !AUTO! commands by
writing a flag in the file PULRES.FIL, deleting it caused an infinite
loop. Don't delete the file... to break the loop, start the menu
shell with the command line parameter IGNOREAUTO.
2) The path to PULLRES.FIL is impaired or in error. Check pathing by
starting the system with the command line parameter DEBUG. (See
Advanced Pathing in Appendix)
PROBLEM: Logitech mouse fails to operate properly under any conditions, and
causes intermittent "Subscript out of range Module DIALOGIC address
####:####" errors exiting to DOS.
CAUSE:
1) The Logitech mouse manufacturer has designed a mouse driver that is
NOT strictly MS Mouse compatible. MicroDynamics is working with the
software firm which produced the assembler code for mouse handling to
solve this dilemma quickly. Disable the mouse until we can crack this
one...
PROBLEM: System halts and exits unexpectedly with an error message in the
format "Fatal Error at ####:####"
CAUSE:
Fatal internal error. Might be a bug, and should be reported with all
circumstances to MicroDynamics. Our policy is that if it is a
PullDown bug that can be solved, we will solve it and ship a working
copy to you free of charge in under one week.
TRY FIRST:
If you are using a CLONE VGA card: restart the menu system. Likely
the system is returning VGA to the menu shell and does NOT correctly
support the 43 or 50 line video mode. If the system fails again,
delete the file PULLDWN.CNF. It is a read-only file, and thus you
will have to use a PCTools or Norton utility to delete it, or use the
DOS attribute command to strip the attribute and delete the file.
Comments: The vast majority of internal errors are elegantly handled
within the system, and the fault tolerance is very high. Most errors
are not "fatal"-- that is they do not cause the system to exit to DOS.
Those that are, like corrupt .DEF files with no ensuing valid user
response as to what file to load, corrupt configuration files,
completely invalid .DEF files, and more are handled internally. IF
the system ever exits to DOS with a fatal error, a detailed screen
describing the problem and where to call for technical support is
likely to follow. If not, the reason is technical, and you should
call MicroDynamics for help. We will be happy to assist even
unregistered users as time becomes available. Debug requests and help
calls from registered users, of course, take priority, but we want you
to be happy first, and THEN register the product if you are having
problems.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 42
APPENDIX B: FILES INCLUDED IN THE PACKAGE OR CREATED BY PULLDOWN v2.30
___________________________________________________________________________
Files used to run the system:
----------------------------
PULLDWN.BAT .......... Main command to start the menu system
MENU.BAT ........... Calls PULLDWN.BAT for convenience.
PULLDWN1.EXE .......... Executable called upon in PULLDWN.BAT
PULLDWN.DEF .......... Default menu definition file.
PULLDWN.HLP .......... Main help file for ALL F1 help menu definitions
Files created by PullDown to run the system
(Not on disk or in .ZIP file):
-------------------------------------------
PULLDWN.CNF ........... Binary encrypted file containing colors etc.
PULLRES.FIL ........... Binary file containing resume information
TEMPPULL.BAT ........... File called upon in PULLDWN.BAT with SHELL.BAT
SHELL.BAT ........... User-defined batch file. Parameters passed to it
within TEMPPULL.BAT as SHELL %1 %2 .... %0
Documentation:
-------------
READTHIS.NOW ........... A file for the power user who will not read this
PULL230.DOC ........... This file, the main documentation file on disk
QREF.DOC ........... A quick reference one sheet card to keep by your
keyboard when first using the system.
UPGRADE.DOC ........... Specific instructions for v2.01 or earlier users
who are upgrading to v2.30
REGFORM.DOC ........... Registration mailers. IF YOU NEED AN INVOICE,
WE WILL BE HAPPY TO BILL YOU IN LIEU OF RETURNING
THIS FORM.
PULLDWN.REG ........... Registration help screen for OPTIONS pulldown
VENDOR.DOC ........... Vendor data requested by ASP and P(S)L
Extras:
------
ADVANCED.DEF ........... Advanced samples for your inspection
WINDOWS.DEF ........... A mock MS WINDOWS menu for your inspection
SAMPLE.HLP ........... A sample external help file for SCROLLBOX calls
AUTOEX.DEF ........... Demo of !AUTO! command use
PATHS.$$$ ........... PATHS.USR example (See Advanced Pathing/LAN)
VFILE.COM ........... Complimentary file view utility
For more on advanced pathing options, see APPENDIX G: Advanced Pathing
DISK/FILE I/O ERRORS
--------------------
IF PullDown encounters an unexpected file condition, you will be prompted
to either input the correct file, or sent to DOS with a specific help
screen concerning what is wrong and how to fix it. If you do get a
somewhat technical error message like "Error Cnf() FOpen() [1]" then call
for technical help. It may mean you are out of disk space, but most likely
a hardware error has occurred and you should seek assistance in fixing the
condition.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 43
APPENDIX C: FOREIGN VERSIONS/TECHNICAL SUPPORT OVERSEAS
___________________________________________________________________________
First, if you are registering the product outside the USA, you must either:
1) Remit in United States Dollars
2) Remit in your local currency by check or money order PLUS 20% to
cover currency conversion and handling charges here in the US.
3) Contact your local country/region distributor. To date, only
Germany has a distributor, so that is the only country in which you
may to contact them directly.
If you are in Germany, contact:
MicroServe, GmbH
Leher-Laempel-Weg 41 A
D-2800
Bremen 41, Germany
CompuServe ID: 73727,475
BBS: +49-42-983-0086
A German language version of the documentation will be available in the
future, and there is a strong possibility a full German language operating
version will be made available in 1991.
In any other country, contact MicroDynamics Development directly as
described within the preceding section REGISTRATION AND TECHNICAL SUPPORT.
APPENDIX D: Technical Notes on PULLDWN1.EXE Creation.
___________________________________________________________________________
PullDown was created entirely within the QuickBASIC Extended environment in
conjunction with the Assembler Library QuickPak/Professional for BC7 from a
fine company called Crescent Software located at 32 Seventy Acres, West
Redding, CT 06896, (203)-438-5300 CIS 72657,3070. The dialog boxes were
created using DIALOGIC from DIALOG Software. The DIALOGIC system can also
be purchased from Crescent. The AutoHelp system used to display the help
screens is a commercial product available from MicroDynamics development,
and may be included in the upcoming utilities pak for DIALOGIC owners
through DIALOG software. Conversation concerning QuickBASIC is also
invited on the tech support BBS systems. Enjoy, and happy coding! (Source
for AutoHelp is available to DIALOGIC owners for the asking.... so call or
write if you want a copy. Full source for PullDown is not presently
available.)
_____________________________________________________________________________
PullDown v2.30 Documentation Page 44
APPENDIX E: Key Word Crossreference/Quick Reference Long Format
___________________________________________________________________________
By Usage:
Menu Definition Commands:
-----------------------
DEF
Defines a new title heading to follow, and a new pulldown set.
%TitleString
1) When immediately following DEF, defines top menu selection
2) When second through last for a menu, defines the title of the
selection definition that follows it.
+BatchCommand
Following a %TitleString defines a DOS batch command associated
with the preceding selection title.
'CommentString
Anything preceded by ' is a comment and ignored by PullDown.
Embedded comments are not supported, so keep them on separate
lines.
!AUTO!
Automatic executing .DEF command heading. Used like %TitleString
And the basic structure of ALL .DEF files is:
---------------------------------------------
DEF
%TopBar Title One
%First Selection
HI=nn
+batch command
+batch command
%Second Selection
HI=nn
+batch command
+batch command
.
.
DEF
%TopBar Title Two, appearing to the RIGHT of the preceding menu
%First Selection, Menu Two
HI=nn
+batch command
+batch command
%Second Selection, Menu Two
HI=nn
+batch command
+batch command
_____________________________________________________________________________
PullDown v2.30 Documentation Page 45
.
.
And so on, up to 10 total top bar menus, limited in depth down the screen
to the number of rows on the screen minus four.
Where: HI=nn is the HiLite key number, counted in left to right starting at
zero. Example: %Lotus 1-2-3 followed by HI=6 highlights the 1.
PASS=PassWord
User is prompted for a password to continue. The selection halts
execution at the line PASS is encountered if the user cannot enter the
correct response or selects <Cancel> or presses ESC.
?QuestionString
Shows the user PromptString and awaits input. If the user selects the
<Cancel> or presses ESC, the execution of the selection halts and the
user is returned to the menu. Up to 10 are supported, and passed to
the batch file on a command line as if keyed.
OKBOX=PromptString
Places a single <Ok> dialog box before the user containing only the
string PromptString. If the user clicks on <Ok>, or presses ENTER,
then execution continues. If ESC is pressed, then the user is
returned to the menu without action being taken. HighLite keys are O
in <Ok> only.
YORN=PromptString
Places a single <Yes><No> dialog box before the user containing only
the string PromptString. If the user clicks on <Yes>, or presses
ENTER, then execution continues. If ESC is pressed or <No> is
clicked, then the user is returned to the menu without action being
taken. HighLite keys are Y in <Yes> and N in <No>.
SCROLLBOX=HelpFile,HeaderString
Presents user with an <Ok> scrolling mouse sensitive dialog box
containing up to 50 lines of user-defined help in the text file
HelpFile. Presents the lines directly following the first encounter
of HeaderString (so make it unique in the file, or the first
occurrence) up to the stop marker ### on a line by itself.
@MenuFile.DEF
Loads a the MenuFile[.DEF] menu definition file from the .DEF path.
This path is either:
1) The path to PULLDWN1.EXE -or-
2) The path set in the PULLDWN=Path environment variable, if
present. (Optional)
[.DEF] denotes that the extension is optional. Strongly recommended
that you follow syntax with .DEF to prevent confusion.
LOADFILE=FileSpec,HeadingComment
Presents user with a professional style file load dialog, complete
with the ability to traverse the entire system, event handling, and
mouse support. The Heading Comment is optional, but encouraged. This
dialog returns to the command line the file name entered by the user.
A new file name can be entered at will, but the dialog will remind the
user that the file does not yet exist before continuing.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 46
APPENDIX F: Performance Optimization (Load Time Minimization)
___________________________________________________________________________
Some guidelines and a special .DEF command are given below to help you
minimize the time it takes PullDown to parse and load the text files used
for menu definition... all .DEF files, that is. In a future version, a
separate compiler will be included, and PullDown will flash to your screen
with the menus you define. However, for now, a performance hit occurs when
the text file is parsed. Some optimizing techniques can be used to
minimize the load time for you, and if you use all of them you will be
happier with the performance. [Remember, PullDown loads large amounts of
information relative to most menuing systems....]
1) After you have settled on a particular .DEF file definition, place the
number of DEF statements present in the file on the FIRST line of the .DEF
file, preceded by MAXDEFS=. Sample:
MAXDEFS=4
Misdefining here does nothing fatal, but will result in a dialog box
telling you of an error. The maximum is 10, anything higher is ignored.
An example is included in ADVANCED.DEF.
2) Use the letter combination DEF a minimum number of times in the .DEF
file. The reason is somewhat technical, but in lay terms the system stops
and looks for the keyword DEF on a line by itself EVERY time it encounters
the three letters DEF in sequence. It is not a noticeable performance hit,
and is vastly superior to testing the first three nonblank characters of
each line, but if even the embedded three letters DEF occur many times, you
are slowing the system down for no reason. This comment applies really to
those who might otherwise overcomment the file and refer to the DEF file
etc. many times.
3) Minimize the overall size of the .DEF file. Do not include huge sets of
batch commands, place them in separate batch files and call those files
from within PullDown. .DEF files larger than about 20K are not really
useable due to the performance decrease on non-80386 or higher machines.
4) Minimize the number of comments within the .DEF or .HLP files. Again,
more to scan, more to load.
5) Don't bother putting the menu system on a RAM disk.... it does not help
you much. PullDown is very efficient in loading the .DEF files into
memory, and that operation is a small portion of the total time it takes
PullDown to start. In the compiler versions, it might be a factor, because
then the time to load the .EXE and .DCF files will be relatively important.
6) If you are using an IBM mouse, or some clone mice, the load time on a
serial unit is likely to be impacted by the version of the mouse driver you
have. Be safe: just get the latest. MS makes the driver available to
users many ways, the latest of which is the new driver included with
Windows v3.0.
7) As an aside, the leading blanks or tabs used to make the file readable
do NOT a performance decrement. Use them freely.
8) Scanning of .HLP files for the header and reading the lines is very
fast, and will mostly depend upon disk access time. Slower disk, longer
time to scan. Larger files are not likely to cause a detectable
performance decrease on newer 80286 or higher based hardware.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 47
9) Use a version of DOS over 3.0. There are several file I/O goodies in
that version not available in 2.xx DOS. The system is untested under v2.xx
of DOS, but should function normally. To date, no trouble has been
reported to MicroDynamics under any v2.xx of DOS.
APPENDIX F: Advanced Pathing/LAN Support and Setup
___________________________________________________________________________
PullDown v2.30 contains advanced pathing support for users or LAN
administrators who might require it. The following documentation is
intended for use by professionals, but examples are supplied in hopes of
conveying some useful information to those who might need it for simpler
purposes.
NOTE: These variables may be defined EITHER using environment commands (SET
VarName=Path) -or- within a flat file in the default directory called
PATHS.USR to save precious environment space. PLEASE read all of this
section or none of this section. Going off "half cocked" with these
variable assignments will likely lead to frustration!
Enviroment variable Purpose
---------------------------------------------------------------------------
PULLDWN Used for ALL OTHER subsequent environment
varibles IF they are not set to something
else. If not set, the default DOS
directory is assumed, *not* the path to
PULLDWN1.EXE as in prior versions.
PULLTMP Used for TEMPPULL.BAT, SHELL.BAT and
PULLRES.FIL. PullDown *must* have write
access to this directory.
PULLDEF Path to *ALL* .DEF files, even those
called upon within @DefFile commands.
Write access optional, but needed if
LAN users are permitted access to these
files for modification. (Also path to
*.REG)
PULLHLP Path to ONLY the master PULLDWN.HLP file,
which is used only to define help for the
menu selections. This path is NOT
appended to SCROLLBOX=HlpFile,HeaderString
calls.
PULLCNF Path to PULLDWN.CNF and any future .CNF
files. Write access is NOT needed if the
product is registered, but IS required if
the product is unregistered.
Example:
--------
1) You have a laptop, and want the .DEF files read from a ramdisk on
D:\RMDISK, but all others read from C:\MENU, from which the menu
system starts. Your enviroment settings (DOS command) would be:
SET PULLDEF=D:\RMDISK
_____________________________________________________________________________
PullDown v2.30 Documentation Page 48
* Note: a trailing \ is OPTIONAL on path settings for PULLDWN
2) Same as above, only you want to start from the root directory and
still have PullDown read all files except .DEFs from C:\MENU
SET PULLDWN=C:\MENU
SET PULLDEF=D:\RMDISK
To accomplish this, you might want to modify PULLDWN.BAT to include the
above SET commands, so that you could be sure it would work each time you
started it. A word of caution: if you start PullDown from a directory other
than the default, then be SURE that the command to invoke TEMPPULL within
PULLDWN.BAT points right to the batch file, -or- can be accessed by DOS in
the PATH. TEMPPULL.BAT will contain a EXPLICIT path to SHELL.BAT, as
defined by PULLTMP in the environment.
Example:
-------
3) More laptops...
You want to configure your laptop so that the .DEF files are read from
C:\MENU\DEF, the system starts from C:\, and all other files from
C:\MENU. You might modify PULLDWN.BAT to look like this:
ECHO OFF
CLS
C:
CD\
SET PULLDWN=C:\MENU
SET PULLDEF=C:\MENU\DEF
\MENU\PULLDWN1.EXE %1 %2 %3
\MENU\TEMPPULL
As you can see, maximum flexibility in defining paths is permitted. This
means that LANs can also be supported, with some careful attention to paths
used when the system is set up.
LAN SETUP
=========
The following paths might require WRITE access:
-----
PULLTMP For the temporary batch files
PULLCNF IFF you are unregistered and/or users have access to options
Write access not required if you are both registered and your
users do not have access to the configuration screens.
PULLDEF IFF users are permitted to modify the .DEF files
PULLHLP IFF users are permitted to modify the master PULLDWN.HLP file
Using the rules presented above, make intelligent decisions concerning
where the files should be pathed. IF ENVIRONMENT SPACE IS A PROBLEM, see
the following section concerning the use of a special file PATHS.USR.
PATHS.USR, if found in the DEFAULT directory at startup, will be searched
for valid path settings. The environment will NOT be checked if this file
exists, even if PATHS.USR contains nothing of value. The file cannot be
more than 50 lines long, and can contain comments preceded by the '
character, and will ignore leading/trailing blanks, as well as embedded
_____________________________________________________________________________
PullDown v2.30 Documentation Page 49
comments on a valid line. Invalid lines are ignored, but you can check the
validity of your pathing using DEBUG on the command line. The syntax of
the PATHS.USR file follows:
' Comment.... ignored. Embedded comments supported.
PULLDWN=Path1
PULLTMP=Path2
PULLDEF=Path3
PULLHLP=Path4
PULLCNF=Path5
* Invalid lines ignored completely
* 50 lines in the file, maximum. (Halts on error - Fatal)
* Variable assignments cascade FROM PULLDWN to others, if
the others are unassigned.
* Order of entry in the file is irrelevant
* Subsequent reassignment of any one variable replaces prior
* All assignments are optional. Default DOS directory assumed
if PULLDWN not specified, path set as in PULLDWN if PULLDWN is
specified. Essentially, if you don't assign a value to PULLDWN,
paths not specified assume the default directory. If you do
assign PULLDWN, paths not specified are equal to PULLDWN's
value. [If PULLDWN is not set, it is NUL and thus the
default directory.]
* If the file PATHS.USR exists, the DOS environment is NEVER checked
for variable settings... instead, whatever the result of examining
the PATHS.USR file is, it is used.
* Performance hit to check file is minimal, but is something to
consider on slower 8088/8086 systems or diskless stations accessing
a slow shared volume.
* Sample is provided in the package, only it is names PATHS.$$$ when
shipped.
* Use of other environment variables, as in %VarName% is not supported
at this time within the flat file.
Remember, PullDown never just exits to DOS without an explanation, so you
should get errors that you can debug with if you have misdefined a path.
However, if you want extensive help in checking out which, if any, of your
paths are invalid and WHY, then start the system with the command line
paramter DEBUG.
DEBUG and PATH TESTING
----------------------
Starting PullDown with the command line DEBUG (any case) will result in
PullDown VALIDATING and reporting any errors associated with all paths
in use. This is a nice feature permitted you to discover why and where
a path you have set is causing you problems. The system will halt as it
checks each, beeping on error, and displaying EXACTLY the paths in use, and
their associated environment variable assignment names.
APPENDIX H: SPECIAL THANKS
___________________________________________________________________________
- Crescent Software and Dialog Software for support and superior tools
- Ted Rosenberger of TARGET Software for performance tweaks and advice
- Ray Novino for excellent Sysop support on RunWay BBS
- Peter Rucci for great support and fine Sysop help on the DelChes BBS
- Conrad Kreyling for code, help, encouragement and many ideas
- John Hanks of Skagit Valley Computer Solutions for testing and assistance
- Paul Schauble for LAN testing and BETA advice on 2.30
_____________________________________________________________________________
PullDown v2.30 Documentation Page 50
- One hundred ShareWare authors I cannot name, and the ASP, for setting
fine examples to follow over the last four years.
- Brenda Donovan (and Ed) for testing v2.01 BETA
- The many registered users and sites that provide the economic incentive
to continue the insane pursuit of product development
* Dedicated to Pat.
APPENDIX I: What's Next for PullDown?
___________________________________________________________________________
Two highly skilled programmers have joined in the development effort of
PullDown, v3.00. Planned enhancements include:
* .DEF file 'compiler' (tokenizer) to vastly cut load time of any .DEF
file, while providing exhaustive error trapping and return of error codes,
error messages, and line numbers of errors for external editors.
* Integrated "smart" editing environment, with dual user levels ranging
from novice to expert.
* Automated system scanning installation routine, with automatic detection
of executables and .DEF setup. Interactive and flexible.
* Requested enhancements, as they become required.
* Possible upgrade for the complimentary utility VFILE.COM, if demand
warrnats it. Mouse support is likely, but will not be done if no interest
is shown.
_____________________________________________________________________________
PullDown v2.30 Documentation Page 51
APPENDIX J: MicroDynamics Policy Statement
___________________________________________________________________________
We want you to be happy first, and then register the product. To that end,
we will:
* Support any user of any version, registered or unregistered, for any
period of time. Unregistered users will receive technical support until
the time requirement of doing so impairs the support of registered users.
* Permit downloading of the latest version of all forms of our products,
without restriction or fee.
* Support unlimited FREE shareware upgrades of our products via command
line registration.
* Make all of our future versions automatically upgrade critical system
information withot requiring user intervention, whenever possible.
* Permit downloading of the 80286/80386 specific version of PULLDWN1.EXE
free of charge to all BBS callers.
* Permit any caller, registered or not, to BETA TEST all products prior to
release. Productive and participative BETA sites are always welcome.
* Welcome any enhancement request you may have, and implement it if it is
technically feasible to do so and within the scope of the product
definition.
* Correct any verifiable bugs in under ONE WEEK from the date of
confirmation, and post a working solution for any user, registered or not.
* Respond positively to all complaints and compliments of all users,
registered or not, because the customer is ALWAYS right. Enjoy!
_____________________________________________________________________________
PullDown v2.30 Documentation Page 52